home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / stack_20.zip / ST!SYSOP.DOC < prev    next >
Encoding:
Text File  |  1992-12-11  |  13.9 KB  |  323 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                            Stack'Em!                           /
  4.     /                           Version 2.0                          /
  5.     /                                                                /
  6.     /                        (c) Copyright 1992                      /
  7.     /                        All Rights Reserved                     /
  8.     /                          J & W Software                        /
  9.     /                                                                /
  10.     /                                                                /
  11.     /       DOOR game for Wildcat!, PCBoard 14.x, RA/QBBS, GAP,      /
  12.     /       SPITFIRE  and  other BBS  software which  uses door      /
  13.     /       information files compatible with the above.             /
  14.     /                                                                /
  15.     /                                                                /
  16.     /                           Support BBS:                         /
  17.     /                          Gulf Coast BBS                        /
  18.     /                          (904) 563-2547                        /
  19.     /                     1200 - 14400 HST/v.32bis                   /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     Stack'Em! is  a game where the player has to join different shaped
  27.     falling  pieces  together  to  form  completed  horizontal  lines.
  28.     Scoring is based on how many pieces are played and number of lines
  29.     completed.  Players  compete for weekly high  score as well as All
  30.     Time High Scorer.
  31.  
  32.  
  33.     FEATURES
  34.     --------
  35.  
  36.     - ANSI Color and Mono screens with animation
  37.     - Full multi-node support
  38.     - Support for locked DTE up to 115K bps
  39.     - Support for COM1 through COM8 and IRQs 1 through 15
  40.     - FOSSIL support
  41.     - DESQview aware
  42.     - Easy installation and no maintenance
  43.  
  44.  
  45.     SETUP
  46.     -----
  47.  
  48.     Setup  is  very simple.  Create a directory and  place  the  files 
  49.     STACKEM.EXE and ST!SETUP.EXE in this directory.
  50.  
  51.     Change to this directory and run ST!SETUP.  A screen with  several
  52.     fields  will be displayed.  There will be a box at the  bottom  of 
  53.     the  screen that will  display  help  information for each  field.
  54.     The  following  edit keys  are allowed: HOME, END, BACKSPACE, LEFT
  55.     and RIGHT ARROW. Use the ENTER,  UP  and  DOWN  ARROW keys to move
  56.     between the different fields.
  57.  
  58.     Each field is described below:
  59.  
  60.     Name: The name of the person registering the program as it will be
  61.     displayed on  the opening screen (when registered).  This does not
  62.     necessarily have to be the SysOp, it could be the name of the user
  63.     who donated the registration fee.
  64.  
  65.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  66.     opening screen (when registered).
  67.  
  68.     Key Number:  If registered, enter your Key Number here.  Until the
  69.     program  is registered leave this field  as  all zeroes.   See the
  70.     registration section below for more information about registering.
  71.  
  72.     Allowable plays per day:  The number of plays per day that will be
  73.     allowed.  A value of 0 means unlimited plays per day.
  74.  
  75.     Display 'Next Piece' [Y/N]:  If 'Y', the next piece  to  be played
  76.     will be displayed to the player.
  77.  
  78.     Use the  'Doughnut'  piece [Y/N]:  If 'Y',  the  large  'Doughnut'
  79.     shaped piece will be used.  You may not want to use the 'Doughnut'
  80.     shaped piece if small children will be playing the game.
  81.  
  82.                                    Doughnut
  83.  
  84.                                     ██████
  85.                                     ██  ██
  86.                                     ██████
  87.  
  88.  
  89.  
  90.     Penalty for  Throw Away Piece  command:  Set this to the number of
  91.     points to subtract from the players  score when they use the Throw
  92.     Away Piece  command.  If you  choose to enable  this command it is
  93.     recommended that this be set  to a minimum of 500 points.  A value
  94.     of 0 will disable the command not allowing it to be used.
  95.  
  96.     Number of points per Round:  Set this to the number of points  you
  97.     wish  to use in each round.  At the end of each  round, the screen
  98.     will be cleared of all pieces and  random blocks will be placed at
  99.     the bottom  of the screen.  Each successive  round will  have more
  100.     blocks than the last. If you do not wish to use rounds, then enter
  101.     a value of 0.
  102.  
  103.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  104.     bulletin file. If left blank no file will be written.
  105.  
  106.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  107.     Color) bulletin file.  If left blank no file will be written.
  108.  
  109.     Use  Internal  or  FOSSIL  com   routines  [I/F]:    The  type  of
  110.     communications support  that  should  be used.  Stack'Em! can  use
  111.     either its own  Internal  communication  routines  or an installed
  112.     FOSSIL  driver.  For  systems  not  using a FOSSIL driver,  choose
  113.     Internal  routines.  The Internal  communication routines  support
  114.     COM1 through COM8 with IRQs  of 1 through 15.  For systems using a
  115.     FOSSIL  driver,  you  may choose  either the  Internal  or  FOSSIL
  116.     routines.
  117.  
  118.     Base Address  (COM1 through COM8):  If you are  using the Internal
  119.     communication routines on ports  other than  COM1 or COM2 you must
  120.     enter the Base Address of the ports, in hex, for the ports you are
  121.     using.  Note that  the Base Address  for COM1 and  COM2  cannot be
  122.     changed.
  123.  
  124.     IRQ  (COM1 through COM8):   If  you   are   using   the   Internal
  125.     communication  routines on ports other  than COM1 or COM2 you must
  126.     enter the IRQ of the  ports you are using.  Note that the IRQs for
  127.     COM1 and COM2 cannot be changed.
  128.  
  129.     After entering all of the information, press 'ESC'.  ST!SETUP will
  130.     ask if you want  to save the configuration  file.   If this is the
  131.     first  time  ST!SETUP  has been  run  or  you  have previously run
  132.     ST!SETUP  but  changed some of the information, press  'Y'.   This
  133.     will  create or update the configuration file  (STACKEM.CFG).   It
  134.     will also create a STACKEM.SCO file if one does not exist. This is
  135.     the score file and is needed for the program to run.
  136.  
  137.     ST!SETUP will then ask if you want to create the registration file
  138.     (STACKEM.REG).   The  registration  file will be needed  when  the
  139.     program is registered, so you will need to answer 'Y' at least one
  140.     time for this file to be created.  Please be sure all  information 
  141.     is correct as your 'Key Number' will be based on this information.
  142.  
  143.     Consult your BBS manual regarding the creation of DOOR batch files
  144.     for your BBS.  STACKEM.EXE  must be started from  the directory it
  145.     resides in for the game to function.  The command line for calling 
  146.     Stack'Em! is as follows:
  147.  
  148.     STACKEM STACKEM.CFG 'Full path and name of BBS information file'
  149.  
  150.     'Full path and name of BBS information file'
  151.  
  152.     This  will be the full path and filename of your  BBS  information 
  153.     file.   For  example:  C:\PCB\PCBOARD.SYS.   Stack'Em!  uses  this
  154.     filename  to  determine the BBS software which is  being  used  as 
  155.     follows:
  156.  
  157.     CALLINFO.BBS (Wildcat 2.xx)
  158.     PCBOARD.SYS  (PCBoard)
  159.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  160.     SFDOORS.DAT  (SPITFIRE)
  161.     DORINFOx.DEF (RA/QBBS/RBBS)
  162.  
  163.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not
  164.     fully compatible with RBBS. By default, Stack'Em! uses the RA/QBBS
  165.     DORINFOx.DEF  format.  If  you  are  using  the  RBBS  version  of
  166.     DORINFOx.DEF,  use the parameter  "/RBBS"  (without quotes) on the
  167.     command line in your calling batch file.
  168.  
  169.     An example of a batch file for PCBoard:
  170.  
  171.     CD\STACKEM
  172.     STACKEM STACKEM.CFG C:\PCB\PCBOARD.SYS
  173.     CD\PCB
  174.     BOARD.BAT
  175.  
  176.     An example of a batch file for RBBS using DORINFOx.DEF:
  177.  
  178.     CD\STACKEM
  179.     STACKEM STACKEM.CFG C:\RBBS\DORINFO1.DEF /RBBS
  180.     CD\RBBS
  181.     BOARD.BAT
  182.  
  183.  
  184.     UPGRADING
  185.     ---------
  186.  
  187.     To upgrade from versions  1.5+,  replace the old  STACKEM.EXE  and
  188.     ST!SETUP.EXE  files  with  the  new  version  2.0  STACKEM.EXE and
  189.     ST!SETUP.EXE files and run ST!SETUP.
  190.  
  191.     If you  are  using  the  RBBS  version  of  DORINFOx.DEF,  add the
  192.     parameter  "/RBBS"  (without quotes)  to the  command  line in the
  193.     calling batch file.
  194.  
  195.     To upgrade from earlier versions follow these steps:
  196.  
  197.     1 - Replace the existing STACKEM.EXE with the new STACKEM.EXE.
  198.     2 - Delete your existing STACKEM.CFG.
  199.     3 - Delete your existing STACKEM.SCO.
  200.     4 - Run ST!SETUP to create the new STACKEM.CFG.
  201.     5 - Modify your batch file(s) for the new command line syntax.
  202.  
  203.     Multiple  configuration files are no longer necessary  if  running 
  204.     multi-node.
  205.  
  206.  
  207.     ERRORS
  208.     ------
  209.  
  210.     Any  errors  which may occur  will be written to  the  STACKEM.ERR
  211.     file.  When possible, a descriptive error message will be  written 
  212.     to  STACKEM.ERR  with the exact cause of the error.  If the  error
  213.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS ) and
  214.     upload a  copy of your  STACKEM.CFG,  STACKEM.SCO and  STACKEM.ERR
  215.     files.  This will allow us to more quickly  determine the cause of
  216.     the error.  All support is handled through the Gulf Coast BBS.
  217.  
  218.  
  219.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  220.     ------------------------------------
  221.  
  222.     Stack'Em!  has  been developed  in  a networked  environment.  All
  223.     multi-node features have been thoroughly tested on multi-node sys-
  224.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  225.     full record and file locking is supported.  Multiple configuration
  226.     files are NOT necessary when running on multi-node systems.
  227.         
  228.     Stack'Em! is DESQview aware.  It is automatically detected, screen
  229.     and keyboard I/O are "well behaved",  and time slices are released
  230.     to other applications where appropriate. Stack'Em! has been tested
  231.     with 3  nodes  running  simultaneously under  DESQview  (all ports
  232.     locked at 38400) with no noticeable effect on other nodes.
  233.  
  234.  
  235.     MISCELLANEOUS
  236.     -------------
  237.  
  238.     At the  beginning of  each week the score  file will automatically
  239.     be cleared and last week's high scorer will be determined.
  240.  
  241.     If you are using a high speed modem and have your com port LOCKED, 
  242.     the  program will not respond to keyboard input while  your  modem 
  243.     buffer is full.  This is normal.
  244.  
  245.     Stack'Em! may be played from the DOS prompt by typing:
  246.  
  247.     STACKEM STACKEM.CFG LOCAL
  248.  
  249.     Note the user name is hard coded as 'SysOp' and the bulletins  and
  250.     score file will not be updated. Also, play will not be limited  to
  251.     the allowable plays per day set in ST!SETUP. This mode is only for
  252.     testing.
  253.  
  254.     To turn on screen writing, if it is off, press any key.
  255.  
  256.  
  257.     REGISTRATION
  258.     ------------
  259.  
  260.     Registration is required if you choose to continue using this DOOR 
  261.     program.   After 60 days of running the program unregistered,  the 
  262.     score  file  will  cease to be updated.  However,  the  game  will 
  263.     continue  to allow players to play. This should be long enough  to 
  264.     determine if the program meets your needs and is popular with your 
  265.     users.
  266.  
  267.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  268.     with a 'Registered To:' message.  This will show the Name and  BBS 
  269.     Name from the STACKEM.CFG file.
  270.  
  271.     There are two ways to register.
  272.  
  273.                         * Mail order Registration *
  274.  
  275.     If the STACKEM.REG form was not  previously  created, run ST!SETUP
  276.     and have  it  create STACKEM.REG.  Check this  file to  insure the
  277.     information is correct. If it is not, re-run  ST!SETUP and correct
  278.     any errors.   Your Key Number is based on the information in  this
  279.     file  and must be correct for your Key Number to work.  When done,
  280.     print the form  to your printer.  Send the  completed  STACKEM.REG
  281.     form  along  with your  check,  money order,  VISA,  MasterCard or
  282.     Discover credit card information for $15.00 (US) to:
  283.  
  284.                               J & W Software
  285.                           9426 N. China Pink Way
  286.                       Crystal River, FL  34428-9500
  287.  
  288.     Your personalized Key Number will be sent to you promptly. When it
  289.     is received,  run ST!SETUP  and enter  your Key number.  Stack'Em!
  290.     will then be registered.  No other action is necessary.
  291.  
  292.  
  293.                      * Instant On-Line Registration *
  294.  
  295.     You may register  Stack'Em! with  VISA, MasterCard or Discover and
  296.     receive your personalized Key Number instantly by calling the Gulf
  297.     Coast BBS, (904) 563-2547,  and entering REGISTER at the main menu
  298.     prompt.  You  will need the  Name  and  BBS Name  exactly as it is
  299.     entered on  lines 1 & 2  of  ST!SETUP as well as  your credit card
  300.     information to  register.  You  might  want  to make  note of this
  301.     information to speed  your call.  You will receive your Key Number
  302.     on that call.
  303.  
  304.  
  305.     WARRANTY & DISCLAIMER
  306.     ---------------------
  307.  
  308.     There  are  no warranties, express or  implied,  for  unregistered 
  309.     copies of Stack'Em!.  The author will  NOT  be held liable for any
  310.     direct,  indirect, incidental, or consequential  damage  resulting 
  311.     from  the  use  of  this  program.   Your  use  of  this   program 
  312.     constitutes your AGREEMENT to this disclaimer and your release  of 
  313.     the author from any form of liability.
  314.  
  315.     Registered  copies  of  Stack'Em!  are  warranted  to  perform  as
  316.     described  in this  documentation.  In the  event  Stack'Em!  does
  317.     not  perform as described, the author will elect to either rectify
  318.     the  problem or refund  the amount  paid, provided notification is
  319.     received within 30 days of registration.
  320.  
  321.  
  322.                                  - END -
  323.